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This  document  describes  the  black  box  characteristics  of  the  modified  HP2649A  terminal  ISI 
has  developed  for  the  Military  Message  Experiment  (HP/MME).  the  communication 
interface  between  the  terminal  and  the  host  computer  is  described,  both  in  terms  of  the 
syntax  and  semantics.  The  communication  line  discipline  (protocol)  is  also  described. 


/.  INTRODUCTION 


This  document  describes  the  black  box  characteristics  of  the  modified  HP2649A  terminal  ISI 
has  developed  for  the  Military  Message  Expcrimcn*  (HP/MME).  The  communication 
interface  between  the  terminal  and  the  host  computer  is  described,  in  terms  of  both 
syntax  and  semantics.  The  communication  line  discipline  (protocol)  is  also  described. 

1 he  HP/MME  terminal  consists  of  a Hewlett-Packard  2649A  terminal  with  minor  physical 
modifications  and  special  firmware  developed  by  ISI.  The  firmware  is  contained  in 
programmable  read-only  memories  (PPOM),  which  mount  on  special  boards  designed  and 
produced  by  ISI.  1 hese  boards  plug  into  the  2649  in  place  of  the  HP  control  memory. 
Appendix  V is  a list  of  the  2649  modules  that  go  into  an  HP/MME  terminal. 

Communications  between  the  application  program  in  the  host  computer  and  the  terminal 
consist  of  blocks  of  data  representing  a complete  request  from  the  application  program  to 
the  terminal  (Dispatch)  or  a complete  report  of  some  condition  in  the  terminal  to  the 
application  program  (Notice). 

the  basic  output  model  supported  by  the  terminal  starts  with  windows  of  text  (up  to  7 
may  be  allocated  at  any  time)  which  may  or  may  not  be  mapped  onto  the  screen.  These 
windows  have  upper  and  lower  margins  for  storage  of  text  which  can  be  scrolled  on 
screen.  Each  window  is  divided  into  domains  of  not  more  than  100  characters.  Domains 
have  various  formatting  and  editing  attributes  (e.g.,  enterablc,  editable,  underlined,  etc.). 


The  basic  input  model  is  that  the  user  is  editing/modifying  domains.  After  a user  has 
modified  the  contents  of  a domain  and  moves  the  cursor  out  of  that  domain,  the  new 
contents  are  transmitted  to  the  host  via  a Change  Domain  Notice.  Any  changed  domains 
are  also  transmitted  prior  to  the  transmission  of  a break/function  key  entered  by  the  user. 

The  terminal  docs  its  own  screen  formatting,  within  the  constraints  assigned  to  domains  by 
the  host,  the  terminal  also  handles  its  own  memory  management.  When  it  needs  to  make 
space  available  it  "scrolls"  data  out  of  memory  and  informs  the  computer  by  means  of  a 
Scroll  Notice. 


The  terminal  is  basically  a half-duplex  device  and  at  any  time  is  either  in  input  state 
(keyboard  active)  or  output  state  (computer  active).  Care  has  been  taken  to  allow  the 
application  program  as  much  flexibility  as  possible,  but  the  design  still  dictates  that  certain 
dispatches  cannot  be  safely  transmitted  by  the  computer  during  the  input  state,  these 
dispatcher,  arc  accepted  by  the  terminal,  but  anomalous  results  might  later  appear  to  the 
application  program  or  the  user,  these  dispatches  are  noted  throughout  the  document. 
During  output  state  the  keyboard  is  inhibited  from  activating  the  terminal,  although  the 
keystrokes  may  be  buffered  if  the  user  types  ahead. 
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Tor  oilier  reasons,  Ihe  terminal  might  discover  that  it  cannot  execute  a request  from  the 
application  program.  In  these  situations  an  Error  Notice  is  generated  by  the  terminal 
which  identifies  the  dispatch  which  was  ignored  by  the  terminal.  Error  conditions  are 
noted  in  sections  discussing  the  dispatches  and  are  listed  in  Appendix  IV. 

The  terminal  has  a total  of  16K  bytes  for  display  data  and  domain  data.  Switch  K on  the 
Keyboard  Interface  card  in  the  terminal  controls  the  allocation  of  this  memory.  With 
Switch  K off,  upon  power  up  or  Reset,  memory  will  be  allocated  as  12K  bytes  for  display 
child  storage  and  'IK  bytes  for  domain  storage,  which  is  equivalent  to  256  domains.  With 
Switch  K on,  memory  will  be  allocated  as  8K  for  display  data  and  8K  for  domains  (512 
domains). 

The  terminal  also  contains  a low  level  debug  program,  which  may  be  entered  by  resetting 
thr  terminal  with  Switch  J on  the  Keyboard  Interface  card  activated  (on).  This  debugger 
(Roach)  is  described  in  a separate  document. 
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II.  DISPATCHES 

fcach  dispatch  is  represented  by  a string  of  7-bit  characters  for  the  purpose  of 
transmission  from  the  application  program  to  the  terminal,  the  first  byte  is  the  total 
number  of  bytes  in  the  dispatch  (including  this  count  byte).  The  second  byte  is  the 
function  code.  Following  bytes  are  the  parameters  for  the  function.  All  parameters  are 
required,  of  fixed  format,  and  (except  for  a possible  single  text  parameter)  of  fixed  size. 


1 he  rest  of  this  section  is  organized  in  5 subsections. 

A.  Window  Dispatches 

These  dispatches  provide  the  capabilities  for  window  allocation  and  mapping. 

B.  Domain  Dispatches 

These  dispatches  provide  the  capabilities  for  creation  and  modification  of 
domains. 

C.  Cursor  Dispatches 

These  dispatches  provide  for  controlling  the  position  of  the  cursor. 

D.  Flash  Dispatches 

These  dispatches  provide  the  capability  for  unstructured  (write-only)  output 
to  the  screen. 

F.  Miscellaneous  Dispatches 

Appendix  III  gives  an  example  of  putting  a new  window  on  the  screen  to  demonstrate  the 
use  of  these  dispatches. 

A.  WINDOW  DISPATCHES 

I lie  first  level  of  text  structuring  within  the  HP/MME  is  that  of  windows.  There  are  seven 
possible  windows  identified  by  a window  number  (1  through  7).  Windows  may  be  mapped 
onto  the  screen  to  allow  the  user  to  view  them.  Mapping  and  unmapping  windows  already 
stored  in  the  terminal  allow  the  application  program  to  change  the  user’s  screen  quickly. 

The  Window  dispatches  are: 
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1)  AllOCATE 
?)  [)l  ALLOCATE 

3)  MAI’ 

4)  UNMAI’ 
b)  Cl  F AR 

6)  CHANOf  ATTRIBUTES 

1.  Allocate  Window  Dispatch 

<1>  <WINLX)W>  <AT  T RiBUTES>  <SECURITV  LEVEL> 

A Window  is  allocated,  but  is  not  mapped  on  to  the  screen.  The  identifier  of  the  window  is 
p.iven  in  the  <WINDOW>  byte.  An  Error  Notice  is  generated  if  this  window  identifier  is 
greater  than  7 or  if  the  window  is  already  allocated.  The  first  parameter  defines  the 
window  attributes,  which  arc  shown  below: 

Window  Attribute  Bits  (octal) 

100  - Do  not  reclaim  (i.e.,  No  Scroll  Notices) 

from  the  Upper  Margin. 

40  - Do  not  reclaim  (i.e.,  No  Scroll  Notices) 

from  the  Lower  Margin. 

?0  - Mask  for  Margin  Reclaim  Control. 

10  - Upper  Margin  Vacancy  Control  (1  - Do  Not 

send  Vacancy  Notices  on  Upper  Margin). 

4 - lower  Margin  Vacancy  Control  (1  r Do  Not 

send  Vacancy  Notices  on  Lower  Margin). 

? - Mask  for  Lower  Margin  Vacancy  Control. 

1 - Si7C  (0  - small,  1 *=  large). 

the  discussion  of  "Change  Window  Attributes"  dispatch  (Section  II  A 6)  describes  the 
detailed  operation  of  these  attribute  bits. 

<5t  CURITY  LFVEL>  denotes  the  classification  level  for  the  window.  Valid  security  codes 
are: 

Unclassified  - Md" 

Confidential  - "c" 

Secret  - "S" 

Top  Secret  - "T" 
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2.  Deallocate  Window  Dispatch 

<?>  <WINDOW> 

Deallocate  the  specified  window,  releasing  its  contents.  If  the  window  is  mapped  onto  the 
screen,  the  screen  area  is  cleared  and  made  available  for  mapping. 

3.  Map  Window  Dispatch 

<3>  <WINDOW>  <SCREENLINE>  <SCREENLINE> 

The  specified  window  is  mapped  onto  the  visible  screen.  1 he  two  screen  line  parameters 
(respectively,  inclusively)  specify  the  first  and  last  lines  on  the  terminal  that  the  window  is 
to  occupy.  If  the  window  is  already  mapped  onto  the  screen  or  the  lines  are  already  in 
use,  an  Error  Notice  is  generated  and  the  Map  Dispatch  ignored. 

4.  Unmap  Window  Dispatch 

<4>  <WINDOW> 

The  specified  window  is  removed  from  the  visible  screen.  The  position  of  the  cursor 
within  Ihc  window  and  the  display  text  is  retained.  If  the  window  is  already  unmapped,  an 
Error  Notice  is  generated  and  the  dispatch  is  ignored.  This  dispatch  cannot  be  safely 
transmitted  during  input  state,  as  the  user  might  be  editing  the  window. 

5.  Clear  Window  Dispatch 

<b>  <WINDOW> 

Clears  the  contents  of  the  specified  window,  leaving  the  window  allocated.  If  the  window 
was  on  the  screen,  that  area  of  the  screen  is  cleared,  but  still  remains  mapped. 

6.  Chanpc  Window  Attributes 

</l'l>  <WINDOW>  <ATTRIBUTES>  <SECURITY  LEVEL> 

The  window  attributes  and  security  level  of  the  specified  window  (described  in  Allocate 
Window  Dispatch)  arc  replaced  with  new  attributes  and  security  level.  There  are  three 
types  of  attributes.  Window  Size  is  always  set  by  this  dispatch.  Reclaim  Controls  and 
Vacancy  Controls  each  have  mask  bits  associated  with  them,  so  they  may  be  independently 
controlled. 


1 lie  Reclaim  Controls  (bits  100  and  40  with  mask  bit  20)  allow  the  application  program  to 
"lock"  portions  of  text  into  display  memory.  When  the  terminal  surveys  its  memory 
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assignment  to  windows  in  order  to  reclaim  memory  for  subsequent  use  (i.e.,  generate 
Scroll  Notices),  it  will  examine  these  bits  of  the  Window  Attribute.  Any  window  margins 
marked  "Not  Rcclaimablc"  will  not  be  scrolled  out  of  memory.  Of  course,  if  the  application 
program  locks  loo  much  data  in  memory,  the  terminal  will  eventually  run  out  of  space  (the 
te  rminal  limit  is  2b 6 domains  and  12,000  bytes  cf  display  data).  It  will  then  generate  an 
Irror  Notice  (1  rror  1 ype  1?)  and  will  reject  all  subsequent  dispatches  except  ones  that 
fre  e-  up  memory  (Delete  Domain,  Clear  Window,  Deallocate  Window  or  Reset),  until  free 
memory  exceeds  the  minimum  threshold. 

The  Nol -Rcclaimablc  attribute  for  windows  gives  a mechanism  to  avoid  a race  condition 
where  the  host  computer  is  writing  information  relative  to  data  that  the  terminal  is 
simultaneously  scrolling  out  of  its  memory,  lo  avoid  this  condition,  the  host  sets  the 
window  attributes  to  "Not  Reclaimable"  for  the  window  it  plans  to  write  into.  Now  the  host 
has  "control"  over  that  window  and  it  is  free  to  write  into  it  without  fear  of  conflict  with 
the  terminal.  Whenever  the  terminal  generates  a Vacancy  Notice  on  the  margin  of  a 
window  (see  Section  III  ft  2),  it  will  set  the  Not-Redaimable  bit  for  that  same  margin.  This 
inhibits  the  terminal  from  sending  Scroll  Notices  on  that  margin.  When  the  host  is  finished 
sending  data,  it  must  set  the  window  margins  to  "Rcclaimablc". 

1 he  Vacancy  Control  bits  (bits  20  and  4)  have  similar  functions  relative  to  Vacancy  Notices. 
If  the  application  program  wishes  to  receive  Vacancy  Notices  for  a margin  of  a window,  it 
/crocs  the  appropriate  Vacancy  Control  bit.  If  it  does  not  want  Vacancy  Notices  (e.g.,  if 
there  is  no  further  data  to  send  for  the  margin  of  that  window)  it  sets  the  bit. 

When  flic  terminal  delcrmincs  that  a mapped  window  margin  is  below  its  vacancy  threshold 
(currently  set  at  half  the  number  of  lines  mapped),  it  will  examine  if  vacancies  are 
permitted  for  this  window  margin.  If  so,  it  will  send  a Vacancy  Notice  and  set  the 
Not  Rec laimable  bit  for  the  margin  and  a global  No  Vacancy  flag.  The  terminal  is  now 
inhibited  from  sending  Scroll  Notices  from  that  margin  or  any  further  Vacancy  Notices  on 
any  margin.  When  the  application  program  receives  the  Vacancy  Notice,  it  normally 
responds  by  sending  additional  data  for  the  margin.  When  it  has  sent  an  appropriate 
amount  of  data,  the  host  sets  both  margins  for  the  window  to  Rcclaimablc.  This  dispatch 
(Change  Window  Attributes  with  bit  20  = 1 and  bits  40  and  100  »■  0)  also  clears  the  global 
No  Vacancy  flag  automatically,  in  essence  asking  for  another  Vacancy  Notice  when  the 
conditions  warrant  it.  Note  that  if  the  application  program  determines  that  there  is  no 
fui  t her  data  to  send  on  one  or  both  of  the  margins,  it  should  set  the  Vacancy  Control  bits 
appropriately  with  this  same  dispatch. 

1 he  size  attribute  is  simply  an  indication  of  the  anticipated  size  of  the  window.  The  actual 
si/e  is  determined  by  how  much  data  is  entered  in  the  window,  and  it  normally  increases 
or  decreases  through  time. 

Since  the  terminal  sets  the  Vacancy  Control  bits  asynchronously  from  the  host,  the  host 
does  not  necessarily  know  the  state  of  these  bits.  In  order  that  the  host  does  not 
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inadvertently  rer.et  a Vacancy  Control  bit  with  a Change  Window  Attributes  Dispatch  which 
was  sent  for  a different  function,  a mask  bit  is  provided.  The  terminal  will  only  change  the 
state  of  a Vacancy  Control  bit  on  a Change  Window  Attributes  Dispatch  if  the 
corresponding  mask  bit  is  a one. 

R DOMAIN  DISPATCHES 

Within  windows  the  application  communicates  to  the  terminal  in  terms  of  domains.  Domains 
represent  the  atomic  unit  for  manipulation  of  text  on  the  screen.  In  addition,  domains  have 
attributes  which  apply  to  its  entire  contents.  Domains  may  be  created  and  deleted  by  the 
terminal  or  the  application  program  in  the  host  computer.  Terminal-generated  domain 
identifiers  have  a one  as  their  high  order  bit.  To  avoid  conflict  computer-generated 
domains  must  have  zero  as  their  high  order  bit. 

The  dispatches  for  domain  manipulation  affect  the  content  of  the  screen  if  they  apply  to  a 
window  which  is  mapped.  It  is  therefore  dangerous  to  send  any  of  these  dispatches  to 
mapped  windows  during  input  state  (keyboard  active). 

1 ) CREATE 

2)  DELETE 

3)  APPEND 
0)  MODIFY 

b) CHANGE  TEXT 

6)  SPLIT 

7)  JOIN 

I.  Create  Domain  Dispatch 

<6>  <WINDOW>  <DOMID>  <LFf  TDOMID>  <CAPAB>  <FORMAT>  <HILITE>  <TEXT> 

Wilhin  the  specified  window,  a new  named  domain  <DOMID>  is  created,  to  the  right  of  the 
domain  <lFFIDOMID>,  with  the  initial  text  contents  specified  by  <TEXT>.  Text  may  not 
exceed  100  characters.  The  special  values  0 and  -1  for  <LFFTDOMID>  denote  that  the  new 
domain  is  to  be  created  at  the  beginning  (0)  or  end  (-1)  of  the  window. 

The  argument  <CAPAB>  specifics  the  set  of  capabilities  for  this  domain,  defined  as  the 
following  bit  positions: 


r == 1 
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Capability  Pits  for  Domains 


100 

fntcrablc 

40 

- Editable 

20 

ML  RE  markers  allowed 

10 

EOL’s  allowed 

4 

Reserved 

2 

Reserved 

1 

Reserved 

I ho  <FORMA1>  argument  provides  the  computer  the  following  control  over  the  format  of 
the  display  of  the  domains. 

Format  pits  for  Domains 

1 - Start  domain  at  left  margin 
2,4  - Reserved 
10,20,00  - Select  Left  Margin 

000  - Left  margin  *=  Column  1 

001  - Left  margin  ■=  Column  9 

010  - Left  margin  «=  Column  17 

01 1 - Left  margin  *•  Column  25 

100  - Lett  margin  * Column  33 

101  - Left  margin  - Column  01 
1 10  - Left  margin  » Column  09 
1 1 1 - Left  margin  = Column  57 

Hit  1 causes  the  domain  to  begin  at  the  left  margin  of  the  next  line,  regardless  of  where 
the  previous  lomain  ends.  1 he  Left  Margin  Control  bits  permit  indentation  of  the  left 
margin  on  a per  domain  basis.  Note  that  an  indented  domain  may  not  start  at  the  left 
margin  (bit  1 * 0),  in  which  case  only  that  part  of  the  domain  which  spills  over  onto  the 
next  line  will  be  indented. 


The  <HIII1L>  argument  selects  combinations  of  the  following  features: 
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HILITE  Bits  for  Domains 

1 - Blink 
? - Inverse  Video 
'I  - Underline 
10  - Half  Brightness 
?0,40  - Select  Character  Set 

00  - Normal 

01  - Alternate  Character  Set. 

10  - Not  used 

1 1 - Non-printing  character  set. 

Useful  for  non-printing  fields, 
e g.,  passwords. 

The  text  of  a domain  may  not  exceed  100  characters.  Note  that  Scroll  Notices  may  be 
generated  as  a result  of  the  Create  Domain  Dispatch. 

?.  Delete  Domain  Dispatch 

<7>  <WINDOW>  <DOMID> 

The  domain  specified  by  <WINDOW>  <D0MID>  is  deleted.  If  the  domain  is  visible  the  screen 
is  changed  appropriately.  No  Notices  are  generated. 

3.  Append  Domain  Dispatch 

<8>  <WINl)0W>  <D0MID>  <1fcXT> 

lhe  text  specified  by  <HXT>  is  appended  to  the  end  of  the  specified  domain.  Note  that 
Scroll  Notices  may  be  generated.  If  the  resulting  domain  is  longer  than  100  characters,  an 
Error  Notice  is  generated  and  the  dispatch  is  ignored. 

V.  Modify  Domain  Dispatch 

<9>  <WINDOW>  <DOMID>  <CAPAB>  <F0RMAT>  <HILITE> 

lhr  attributes  lor  the  specified  domain  (described  in  Create  Domain  Dispatch)  are  replaced 
with  new  attributes.  If  the  domain  is  visible  the  screen  is  changed  appropriately.  Scroll 
Notices  may  be  generated. 

5.  Chanpc  Text  Dispatch 


A 


<10>  <WINDOW>  <D0MID>  <1EXT> 
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1 hr  text  o(  the  specified  domain  is  replaced  by  the  new  text.  Text  may  not  exceed  100 
characters.  If  Hie  domain  is  visible  the  screen  is  changed  appropriately.  Scroll  Notices 
may  be  generated. 

6.  Split  Domain  Dispatch 

<1 1>  <WIND0W>  <0L  DD0MID>  <NEWD0MID>  <INTEGER1>  <BEGINNING/END> 

A now  domain  <NEWD0MID>  is  created  with  the  characteristics  of  <0LDD0MID>  and 
containing  the  <INIEGER1>  number  of  characters  of  the  old  domain;  the  old  domain  is 
shortened  appropriately.  If  Beginning  (0)  is  specified  by  the  last  parameter,  the  new 
domain  is  created  to  the  left  of  the  old  domain,  with  the  first  <IN1EGER1>  characters  in  it; 
if  Tnd  (1)  is  specified,  the  new  domain  is  created  to  the  right  of  the  old  domain,  with  the 
last  <IN11GER1>  characters  in  it.  This  dispatch  docs  not  change  the  screen.  Scroll  Notices 
may  be  generated. 

7.  Join  Domain  Dispatch 

<\?>  <WIND0W>  <KEEPDOMID>  <DELD0MID> 

Ihi'  two  domains  <KtlPDOMID>  <DELD0MID>  are  merged  into  one  <KEEPDOMID>,  whose 
name  and  al tributes  prevail.  This  dispatch  may  change  the  screen.  If  the  domains  are  not 
adjacent  or  if  the  resulting  domain  is  longer  than  100  characters,  an  Error  Notice  is 
generated  and  the  dispatch  is  ignored.  Otherwise,  no  notices  are  generated. 

C.  CURSOR  DlSPAiairS 

There  is  the  potential  for  an  implicit  cursor  position  associated  with  each  window  in  the 
terminal.  This  position  is  used  when  the  user  jumps  the  actual  cursor  into  the  window  or 
when  the  application  requests  the  actual  cursor  to  be  placed  in  the  window.  The  implicit 
cursor  position  is  established  whenever  the  user  moves  the  actual  cursor  into  the  window 
or  the  application  program  sets  it  through  the  dispatches  below.  A window  will  have  no 
implicit  cursor  position  if  one  of  these  two  events  has  not  occurred.  None  of  the 
dispatches  in  this  section  can  safely  be  transmitted  during  input  state  to  any  mapped 
windows. 

there  are  two  degrees  of  freedom  associated  with  the  cursor  position.  The  first  is  the 
character  within  the  window  under  which  the  cursor  resides,  the  cursor  must  be  under  an 
enlcrablc  character,  the  user  changes  this  part  of  the  cursor  position  with  the  Move 
Cursor  Keys.  1 he  application  uses  the  Character  Position  Dispatch. 

the  second  degree  of  freedom  is  where  the  cursor  is  on  the  screen.  The  user  changes 
this  part  of  the  cursor  position  with  the  scroll  Keys.  The  application  uses  the  Screen 
Position  Dispatch. 


The  three  position  dispatches  are: 


1)  Cl  IARAC1ER  POSITION 
?)  SCRfcFN  POSITION 
3)  SHOWvCURSOR 

/.  Character  Position  Dispatch\ 

<13>  <WINDOW>  <DOMID>  <hlTEGERl> 

This  dispatch  places  the  implicit  cursor  on  the  character  position  specified  by  the  integer 
within  the  specified  domain  in  thc\specified  window,  lhc  character  is  a zero-based 
number  (i.c.,  the  first  character  in  thc\lomain  is  position  0).  If  character  position  is  larger 
than  the  domain  length,  the  cursor  is  placed  at  the  end  of  the  domain.  This  dispatch  does 
not  change  the  screen. 

2.  Screen  Position  Despatch 

<1A>  <WINDOW>  <INTEGER1> 

This  dispatch  is  used  to  establish  on  what  part  of  the  screen  the  cursor  will  appear,  by 
placing  the  line  containing  the  cursor  on  the  specified  screen  line  (relative  to  the  first  tine 
of  this  window  on  the  screen).  The  first  on-screen  line  of  the  window  is  line  zero.  The 
screen  is  scrolled  to  place  the  cursor  character  position  on  the  proper  displayed  line.  If 
the  line  number  is  too  large,  the  window  is  scrolled  until  the  cursor  is  on  the  last 
on-screen  line  of  the  window.  Scroll  and  Vacant  Notices  may  thus  be  generated.  The 
terminal  will  not  allow  the  first  line  in  the  window  to  scroll  below  the  top  line  of  the 
window  on  screen.  If  the  window  is  not  mapped,  the  position  is  remembered  and  used  to 
de  termine  which  lines  to  display  when  the  window  is  mapped. 

3.  Show  Cursor 

<lt>>  <WINDOW> 

This  dispatch  moves  the  actual  cursor  from  some  other  window  to  the  implicit  cursor 
position  in  the  specified  window.  An  Error  Notice  is  generated  if  the  window  is  not 
mapped  or  there  is  no  implicit  cursor  position  in  this  window. 

0.  FI  ASH  WINDOW  DISPATCHES 

The  flash  window  is  an  area  at  the  top  of  the  screen  which  is  used  to  transmit 
unstructured,  non-cditablc  text  directly  to  the  screen.  This  screen  area  cannot  be  edited, 
nor  can  the  user  move  the  cursor  into  it.  Flash  window  dispatches  may  be  safely 
transmitted  at  any  time. 
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The  two  (lat.li  window  dispatches  are: 

1)  (LASH  SIZE 

2)  FLASH  TEXT 

1.  f Iculi  Sire  Dispatch 
<)(>>  <IN1EGER1> 

I lair,  dispatch  sets  the  size  of  the  flash  window.  The  initial  size  (following  a reset)  is  zero. 
As  the  screen  has  24  lines,  the  parameter  must  be  between  0 and  24;  otherwise  an  Error 
Notice  is  generated. 

If  the  flash  window  size  is  being  increased,  the  text  currently  in  the  window  is  unchanged. 
If  the  new  lines  arc  already  mapped  to  another  window,  an  Error  Notice  is  generated  and 
the  dispatch  is  ignored 

If  the  flash  window  size  is  being  decreased,  the  text  in  the  lines  to  be  deleted  is  cleared 
from  the  screen.  Ihc  other  flash  lines  are  not  changed.  The  deleted  lines  are  now 
available  to  he  mapped  to  other  windows. 

?.  Flash  7 ert  Dispatch 


<l  / > ♦'SCULF NLINf  > <TEXT> 

I his  dispatch  puts  the  specified  text  on  the  specified  line  of  the  flash  window.  The  first 
line-  of  the-  flash  window  is  numbered  zero.  Possible  conditions  which  generate  Error 
Nolices  arc  that  the  specified  line  is  not  mapped  to  the  flash  window  or  that  the  text  is 
longer  than  /9  characters  (i.e.,  the  text  does  not  fit  on  the  line). 

7 . A USCr  1 1 A NLOUS  DISPATCHES 

The  four  miscellaneous  dispatches  are: 

1 ) HI  I L 

2)  CONTINUE 

3)  RESET 

4)  Sf  I SCREEN  SECURITY  LIGHTS 

I.  Kell  Dispatch 
<1K> 

This  dispatch,  which  can  be  transmitted  at  any  time,  rings  the  bell  in  the  terminal.  Care 
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should  be  taken  when  the  bell  is  runp,  during  the  input  slate,  as  the  terminal  uses  the  bell 
as  an  error  indicator  if  the  user  enters  an  inappropriate  local  edit  function,  lhus,  during 
input  state,  the  bell  might  be  misconstrued  by  the  user. 

?.  Continue  Dispatch 

<]9>  <INI  IGFR1> 


I ollowing  a brcak/function  key,  the  terminal  stops  echoing  the  user’s  keyboard  input,  sets 
the  global  IMo  Vacancy  flag  (see  Section  II  A 6),  and  enters  output  state.  The  host 
computer  is  notified  of  this  condition  by  the  receipt  of  a Break  Notice.  When  the  host 
computer  has  completed  its  output  and  is  ready  to  accept  additional  input,  it  transmits  a 
Continue  Dispatch  to  place  the  terminal  back  into  input  state  with  Vacancies  enabled.  The 
<INItGrRl>  argument  sets  a flag,  which  will  determine  whether  keystrokes  will  be 
buffered  or  thrown  away  (in  which  case  the  bell  will  be  rung)  after  the  next  Break.  On 
initial  power  up  and  after  a Reset,  the  terminal  will  lock  its  keyboard  (keystrokes  will  not 
bo  buffered).  The  host  must  send  a CONTINUE  to  change  this  situation.  A zero  parameter 
to  CONTINUE  will  lock  the  keyboard  after  the  next  Break.  A non-zero  parameter  will  cause 
keystrokes  to  be  buffered. 

3.  Reset  Dispatch 

<?0> 

1 lie*  Reset  Dispatch  initializes  the  terminal.  This  includes  deallocating  all  windows,  setting 
the  flash  window  to  zero  lines,  and  setting  the  terminal  domain  identifier  counter  back  to 
?0000  (octal). 

4.  Set  Screen  Security  Lights 
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III.  NOTICKS 


fatli  notice  is  a string  of  7-bit  characters.  Its  purpose  is  to  transmit  data  from  the 
terminal  to  the  application  program.  The  first  byte  is  the  number  of  bytes  in  the  notice. 
1 he  second  byte  is  the  notice  code  followed  by  the  notice  data.  All  data  is  always 
present,  of  fixed  format,  and  (except  for  a possible  single  text  datum)  of  fixed  size. 

lhc  notices  are  presented  below  in  three  sections: 

A.  Input  Notices 

these  notices  inform  the  application  of  user  inputs  (edits  and  function  keys). 

0.  Memory  Management  Notices 

lliese  notices  inform  the  application  program  that  domains  have  been 
"scrolled"  out  of  the  terminal’s  memory  or  that  there  is  a need  for  new  data 
at  the  lop  or  bottom  of  a window,  they  may  be  generated  in  response  to  any 
dispatch  or  user  action  which  creates  or  changes  the  size  of  windows  or 
domains.  They  may  also  be  generated  in  response  to  dispatch  or  user  action 
which  changes  the  screen  (e.g.,  scrolling). 

C.  Error  Notice 

1 his  notice  is  generated  in  response  to  a dispatch  that  the  terminal  cannot 
handle.  It  is  also  used  as  an  acknowledgment  notice  for  completion  of  a Reset 
dispatch. 

A.  JNf'Ul  NOIICFS 

I hr  input  notices  allow  the  application  program  to  know  exactly  what  the  user  has  typed 
and  the  current  stale  of  the  screen  model  in  the  terminal.  No  input  notices  are  generated 
following  a tfreak  Notice  until  the  terminal  is  put  back  into  input  state  by  a Continue 
Dispatch. 


The  five  input  notices  are: 
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1)  CHANGED  DOMAIN 

2)  EXTRACTION 

3)  BREAK 

4)  HI  RE 
b>  101 

/.  Changed  Domain  Notice 

<0>  «'WINDOW>  <DOMID>  <TEXT> 

Whenever  the  user  edits  a domain,  the  new  contents  of  the  domain  are  transmitted  to  the 
application  before  the  next  Break  Notice.  If  the  entire  domain  was  deleted,  then  the  length 
of  the  text  for  the  contents  is  zero.  These  notices  are  generated  irregularly  during  the 
input  state.  The  application  may  not  safely  respond  to  these  notices  via  domain 
modification  dispatches  (join,  split,  etc.)  until  it  receives  a Break  Notice  (signifying  the  end 
of  input  state). 

?.  Extraction  Notice 

<1>  <WINI)0W>  <0LDD0MID>  <NEWDOMID>  <BEGINNING/END>  <TEXT> 

As  a user  types  new  dala  into  a domain,  at  some  point  the  domain  exceeds  the  maximum 
domain  size.  When  this  occurs,  the  terminal  splits  off  a new  domain.  The  new  domain 
inherits  the  characteristics  of  the  old,  and  its  contents  are  sent  as  <TEXT>.  Eventually  a 
Changed  Domain  Notice  is  sent  for  the  original  old  domain.  <BEGINNING/END>  is  0 when 
the  new  domain  is  to  the  left  of  the  old  domain;  it  is  1 when  the  old  domain  is  to  the  left  of 
the  new. 

Another  type  of  Extract  Notice  is  generated  as  an  adjunct  to  Scroll  Notices  (sec  Section  III 
3 B).  In  this  instance  a domain  which  is  within  the  maximum  domain  size  limitations  may  be 
split  in  order  to  scroll  off  dala  at  even  line  boundaries.  In  this  case  a Change  Domain 
Notice  is  not  generated  for  the  domain  from  which  the  extraction  is  made.  For  this  type  of 
extraction  Bt GINNING/END  is  2 if  the  new  domain  is  to  the  left  of  the  old,  and 
HI  GINNING/END  is  3 if  the  old  domain  is  to  the  left  of  the  new. 

3.  Break  Notice 

<WIND0W>  <D0MID>  <L0C  IN  D0MAIN>  <WIND0W  L0C>  <BREAK  C0DE> 

Whenever  the  user  hits  a break/function  key,  the  application  program  is  notified  through  a 
Break  Notice  Before  the  Efreak  Notice  is  actually  sent,  any  domain  change  that  has  not 
yet  been  sent  to  the  host  will  be  reported  via  a Change  Domain  Notice.  The  Break  Notice 
includes  two  pieces  ol  information.  First  is  the  position  of  the  cursor  at  the  time  the  key 
was  hit.  This  includes  the  window,  the  domain  within  the  window,  the  character  within  the 
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domain  (?oro  is  the  first  character)  represented  as  an  <INIEGER1>,  and  the  line  within  the 
mapped  part  of  the  window  represented  as  an  <INTEGER1>.  The  second  piece  of 
information  is  the  break  code  or  function  key  number  (<INTEGER1>).  Since  the  Break 
Notice  is  initiated  by  a Break  Dispatch,  which  locks  the  keyboard  and  the  global  No 
Vacancy  flag,  the  application  program  must  issue  a Continue  Dispatch  when  it  has 
completed  processing  the  Break. 

There  are  two  additional  notices  to  handle  special  local  edit  keys.  These  keys  are  not 
active  unless  the  domain  is  enabled  for  them;  therefore  the  application  does  not  need  to 
expect  them  in  all  situations. 

4.  Ill  hit.  Notice 

<3>  <WINDOW>  <DOMID>  <LOC  IN  DOMAIN>  <MDOMID>  <ADOMID> 

In  Sections  V and  VI  the  user  interface  is  described.  HLRE  is  a key  which  marks  the 
current  position  of  the  cursor  and  generates  a Here  Notice.  When  the  user  places  a Here 
marker  on  a character,  that  character  is  HILITED  to  show  the  user  where  the  marker  is 
located.  The  marker  is  also  made  to  be  a non-cditable  domain.  In  order  to  do  this,  the 
terminal  must  create  domains  and  inform  the  application  so  that  it  can  reflect  these 
changes  in  its  model  of  what  is  contained  in  the  terminal. 

The  first  three  data  in  the  notice  define  where  the  cursor  (and  now  the  Here  marker)  is. 
The  last  two  parameters  depend  on  where  the  Here  occurs  within  the  original  domain. 

Case  Analysis 

The  re  are  four  cases  for  a Here  marker.  They  are: 

a.  single  character  domain  marked 

The  Here  domain  identifier  <MDOMID>  contains  the  original  domain  identifier 
and  the  auxiliary  domain  identifier  <ADOMID>  contains  0.  <L0C  IN  D0MAIN>  is 
0.  No  domains  are  created,  the  original  domain  has  been  HILITED  and  set 
non-cditable. 

b.  first  character  in  domain  marked 

The  <MUOMID>  is  a terminal-created  domain  identifier  containing  the  first 
character  of  the  old  domain.  The  old  <DOMID>  now  contains  the  rest  of  the 
original  domain.  <ADOMID>  is  0,  as  is  <10C  IN  D0MAIN>. 

c.  last  character  in  domain  marked 
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The  <MDOMID>  is  a terminal-created  domain  identifier  which  now  contains  the 
last  character  of  the  old  domain,  lhc  old  <DOMID>  now  contains  the  beginning 
o(  the  Original  domain.  <Al)OMID>  is  0. 

d.  middle  character  in  domain  marked 

The  <MDOMID>  is  a terminal-created  domain  identifier  which  now  contains  the 
marked  character,  lhc  old  <D0MID>  now  contains  the  beginning  of  the 
original  domains,  and  the  <ADOMID>  is  another  terminal-created  domain 
identifier  containing  the  end  of  the  original  domain. 

5.  EOL  Notice 

<d>  <WINOOW>  <DOMID>  <LOC  IN  D0MAIN>  <ND0MID>  <SPECIAL> 

When  (lie  user  hits  the  "Return"  key,  an  EOL  Notice  is  generated  (See  Section  VI  D 4).  The 
terminal  attempts  to  handle  carriage  return  in  a way  that  appears  natural  to  the  user  yet 
is  compatible  with  the  terminal  controlling  the  formatting  of  the  screen.  Carriage  return  is 
normally  meant  to  indicate  that  the  next  line  is  to  begin  at  the  left  margin,  regardless  of 
where  the  previous  line  ends.  A carriage  return  at  the  beginning  of  a line  inserts  a blank 
line  (a  formatted  domain  with  a single  space),  and  can  be  used  to  indicate  the  beginning  of 
a new  paragraph. 

When  the  user  inputs  a carriage  return,  the  terminal  inserts  a space  at  the  cursor  position, 
splits  the  current  domain  behind  the  inserted  space,  and  sets  the  second  domain  to  have 
the  slart-at-left-margin  format  bit  on.  Two  special  cases  add  to  the  complexity  in  this 
notice,  which  derives  from  the  desire  to  have  the  user  be  able  to  create  lasting  blank  lines 
naturally  whether  the  carriage  return  is  entered  at  the  end  of  the  window  (i.e.,  entering 
new  data)  or  in  the  middle  of  a window  (i.e.,  editing  old  data)  and  regardless  of  the  domain 
structure  surrounding  the  cursor. 

lhc  first  two  arguments  specify  the  window  and  domain  of  the  cursor  position  at  the  time 
of  the  carriage  return.  <LOC  IN  D0MAIN>  is  the  location  in  the  domain  of  the  inserted 
space.  <N[)OMlO>  is  the  new  domain  created.  <Sf’ECIAL>  is  a 2 byte  integer  to  identify  2 
special  cases.  lhc  details  of  the  EOL  function  and  the  notices  generated  are  best 
described  with  several  examples,  which  are  given  in  Appendix  II  to  this  document. 

R AH  MORV  MANAGEMENT  NOTICES 

Whe  n a window  is  scrolled,  the  margin  of  off-screen  text  either  above  or  below  the  screen 
gets  larger,  while  the  other  margin  diminishes.  In  order  to  give  apparent  continuity  to  a 
large  document,  the  terminal  attempts  to  keep  reasonable  margins  on  both  sides. 
Therefore  at  some  point,  data  is  forced  out  of  one  margin,  making  memory  available  for 
data  at  the  end  of  the  other.  Through  window  attributes  the  application  program  can 
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Since  memory  is  dynamically  allocated,  any  of  a number  of  operations  may  spawn  the  need 
for  more  memory,  causing  the  terminal  to  scroll  data  out  ot  a window.  The  dispatches  that 
may  have  this  rflert  are  noted.  1 he  memory  management  notices  inform  the  application  of 
this,  so  that  it  might  provide  new  text  to  the  terminal. 

I he  two  memory  management  notices  are: 

1)  Scroll 
?)  Vacant 

1.  Scroll  Notice 

<!>'*  <WINBOW>  <DOMID>  <10P/B0T> 

1 he  terminal  decides  to  remove  a number  of  domains  from  its  memory;  it  sends  this  notice 
to  inform  the  application  program  that  this  domain  and  all  the  domains  above  (if 
< lOP/BOl  > is  0)  or  below  (if  <10P/B0T>  is  1)  arc  no  longer  in  the  terminal.  The 
application  must  keep  track  of  what  is  in  the  terminal  so  that  it  can  respond  property  to 
Vacancy  Notices  and  return  the  proper  text  to  the  terminal  for  the  user  to  view. 

?.  Vacancy  Notice 

<b>  <WINI X)W*  <10P/B0T>  <FRFF  LINES> 

When  more  text  is  needed  at  one  end  of  a window  to  resupply  the  margin,  the  terminal 
generates  a Vacancy  Notice.  1 his  notice  specifics  where  more  text  is  needed  (<10P/B0T>) 
and  how  many  lines  arc  available.  When  a Vacancy  Notice  is  generated,  the  terminal  also 
sets  a global  No  Vacancy  flag.  This  flag  must  be  reset  by  the  host  (see  Section  II  A 6) 
before  another  vacancy  can  be  generated. 

C.  t KROR  NOl  ICE 

< />  <|  PROP  C0D[>  <F  UNCI  ION  C0DE>  <BYTE1>  <BY1E?>  <BYTE3> 

Whenever  a dispatch  cannot  be  processed  an  Error  Notice  is  generated.  This  is  a six-byte 
notice  which  specifies: 

1.  A single- byte  error  code, 

A single- byte  which  is  the  dispatch  function  code  of 
the  dispalch  in  error,  and 

3.  1 he  first,  second  and  third  parameter  bytes  of  the 
dispatch  in  error. 

Appendix  IV  lists  the  error  codes  and  conditions  that  cause  them. 
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IV.  DATA  FORMATS 


There  are  three  syntactic  data  formats.  These  include  two  types  of  integers  and  text 
strings.  This  section  also  discusses  three  semantic  data  types  which  are  used  throughout 
the  document  (<WINDOW>,  <DOMID>,  and  <SECURITY  LEVEL>). 

A.  SYNTACTIC  DATA  TYPES 

1.  <INTEGER1> 

This  is  a single  byte  and  can  represent  the  numbers  0-177  (octal).  All  parameters  except 
text,  domain  ID’s  and  <SPCCIAL>  in  the  Notice  are  of  this  type. 

2.  <INTEGER2> 

This  is  a double  byte  and  can  represent  the  numbers  0-  37777  (octal).  All  domain  ID’s  and 
<SPCCIAL>  in  the  EOL  Notice  are  of  this  type. 

3.  <TEXT> 

<TfXT>  is  represented  as  ASCII  characters.  The  terminal  provides  128  printing  characters 
(including  Space).  What  are  normally  considered  control  characters  (e.g.,  Carriage  Returns, 
Dell,  Escape)  will  print  as  unique  symbols.  The  HP  2645  manual  shows  the  symbol  set  for 
these  characters.  The  length  of  the  text  is  determined  from  the  total  dispatch  (or  notice) 
length,  given  as  the  first  byte  of  the  dispatch  (or  notice).  This  byte  is  of  type 
<INT  KGER1>. 

D.  SEMANTIC  DATA  TYPES 

1.  <WIND0W> 

A window  identifier  is  represented  as  an  <INT EGER1>  of  value  1 through  7.  In  all 
dispatches  except  Allocate,  if  the  window  has  not  been  allocated,  an  Error  Notice  is 
generated  for  the  dispatch  referencing  the  undefined  window.  In  the  Allocate  case,  an 
Frror  Notice  is  generated  if  the  window  is  defined,  or  is  greater  than  7. 

2.  <D0MID> 

A domain  identifier  is  represented  by  an  <INTEGER2>.  The  application  generates 
identifiers  1 through  17/77.  The  terminal  generates  identifiers  20000  through  37776. 

I he  identifiers  0 and  3/777  are  reserved  for  special  cases  of  left  domain  in  the  Create 


Dispatch.  In  all  dispatches  except  Create,  if  the  domain  has  not  been  created,  an  Error 
Notice  is  generated  for  the  dispatch  referencing  the  undefined  domain.  In  the  Create  case, 
nn  [ rror  Notice  is  generated  if  the  new  domain  is  already  defined  or  a terminal  identifier  is 
supplied. 

3.  SECURITY  LFVEL> 

A security  level  is  represented  by  an  ASCII  code.  If  any  other  than  the  four  defined  codes 
are  received,  an  Error  Notice  is  generated.  The  codes  have  been  chosen  to  be  both  easy 
to  remember  and  different  in  many  bits,  one  from  another.  The  codes  are: 

Unclassified  - Hd" 

Confidential  - "c” 

Secret  - "SM 

Top  Secret  - "T" 


■ 
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V.  I.OC/ll.  EDITING 


In  response  to  user  inputs  from  the  terminal  Keyboard,  the  terminal  software  prepares  and 
queues  up  "internal"  dispatches  similar  to  those  generated  by  the  application  program  in 
the  host  computer  to  perform  the  user  requested  service.  Each  Key  causes  a dispatch  of 
sonic  sort.  If  the  user  request  cannot  be  fulfilled,  or  the  request  was  erroneous,  the 
request  is  ignored  and  the  bell  on  the  terminal  rung.  The  application  program  may  also 
send  any  of  these  dispatches.  The  terminal  does  not  distinguish  their  source.  As 
described  in  Section  I the  terminal  is  basically  a half-duplex  device  and  at  any  time  is 
either  in  input  state  (keyboard  active)  or  Output  state  (computer  active).  It  is  in  input 
stale  that  the  user  may  edit  the  screen  contents.  During  the  output  state,  when  the 
computer  is  in  control,  the  keyboard  may  be  disabled  or  keystrokes  may  be  buffered 
de  pending  on  the  argument  used  in  the  last  Continue  Dispatch  sent  by  the  application 
program. 

The  keys  organize  into  categories:  cursor  movement,  cursor  deletions,  window  control, 
printing  symbols,  function  keys,  and  a few  special  keys.  Window  control  keys  are 
necessary  because  typically  the  screen  can  show  only  a portion  of  the  data  stored  in  a 
window.  In  these  cases  the  additional  data  is  stored  in  margins,  above  and  below  the 
screen.  Window  control  keys  allow  the  user  to  move  this  data  onto  the  screen. 

The  data  contents  of  windows  are  modified  through  the  delete  keys,  printing  symbols,  and 
a few  of  the  special  keys,  as  described  below.  The  printing  symbols  are  inserted  at  the 
cursor  positions  and  do  not  "overwrite."  The  terminal  automatically  formats  the  screen  as 
data  is  inserted.  Data  wraps  from  line  to  line  on  word  boundaries,  where  words  are 
delineated  by  space  or  end  of  line.  On  deletion,  the  screen  is  not  reformatted  until  the 
user  moves  the  cursor  to  a new  line. 

In  genor  a1  the  only  keys  that  always  cause  a notice  to  be  sent  to  the  application  computer 
arc  Iht  function  keys  and  two  special  keys,  HERE  and  Carriage  Return.  Other  keys,  such 
ar-  delation  or  printing  symbols,  do  not  necessarily  cause  notices  to  be  sent  immediately, 
all ho'igh  eventually  the  results  of  all  editing  operation  are  reported. 


VI.  MCA I.  DISPATCHES 


Each  dispatch  is  represented  by  a string  of  seven-bit  characters.  The  first  byte  is  the 
total  number  of  bytes  in  the  Notice.  The  next  byte  is  the  function  code,  followed  by  the 
parameters  (if  any)  for  the  function.  All  parameters  are  required  and  of  fixed  format. 

A.  CURSOR  MOVE  DISPATCHCS 

The  following  dispatches  control  the  movement  of  the  cursor  within  a particular  window. 
1 lie  cursor  move  dispatches  only  move  the  cursor  and  do  not  change  the  data  on  the 
screen.  I rror  conditions  such  as  attempting  to  move  the  cursor  off  the  screen  cause  the 
terminal  bell  to  be  rung  and  the  request  ignored.  Non-enterable  domains  are  shipped 
over. 


1 unc  lion 

Code 

Key 

Description 

<??> 

1 

Move  cursor  up  to  previous  enterablc  line 

<?3> 

1 

Move  cursor  down  to  next  enterable  line 

« 

Move  cursor  left  one  character 

<?h> 

• > 

Move  cursor  right  one  character 

<?h> 

WORD  LEFT 

Move  cursor  left  one  word 

<?/> 

WORD  RIGHT 

Move  cursor  right  one  word 

<?.s> 

[JACK 

Move  cursor  to  beginning  of  current  line;  if 
at  beginning,  move  to  end  of  previous  line 

<?9> 

f WD 

Move  cursor  to  end  of  current  line;  if  at 
end,  move  to  beginning  of  next  line 

IIP 

WINDOW 

Move  cursor  up  to  the  previous  window 

<3C>* 

DOWN 

WINDOW 

Move  cursor  down  to  the  next  window 

Note  that  the  character  move  requests  can  move  the  cursor  to  the  next  or  previous  line  to 
fulfill  the  request.  The  terminal  constrains  the  cursor  to  always  be  in  some  enterablc 
domain.  Thus  a cursor  move  will  occasionally  cause  the  cursor  to  jump.  For  example,  if 
lhc.'  position  above  the  cursor  is  non-enterable,  an  UP  cursor  move  will  put  the  cursor  in 
the  nearest  cntrrablc  domain  to  that  position. 

If  I hr  current  line  has  multiple  "fields”  on  it  (defined  by  non-enterable  domains  followed 
by  colorable  domains)  the  move  cursor  bach  or  forward  a line  will  act  as  "move  field." 
That  is,  (JACK  causes  the  cursor  to  move  to  the  beginning  of  the  current  field  or,  if  at  the 
beginning,  to  the  end  of  the  previous  enterablc  field.  FWD  causes  the  cursor  to  move  to 
flu-  rod  of  the  current  field  or,  if  at  the  end,  to  the  beginning  of  the  next  enterablc  field. 
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B.  CURSOR  DELETE  DISPATCHES 

I hr  following  internal  dispatches  delete  information  on  screen.  When  deletion  and 
subsequent  insertion  are  complete  and  the  cursor  has  been  moved  to  another  line,  the 
window  and  screen  line  are  compacted.  The  domain  must  have  the  capability  "editable"  set 
to  allow  information  to  be  deleted.  If  there  are  multiple  "fields"  on  a line,  these  operations 


delete  only  the  adjacent  field, 

not  the  entire  line. 

F unclion 

Coclc 

Key 

Description 

<30> 

DLL 

Delete  one  character  to  left  of  the  cursor 

<31> 

Del 

Delete  one  character  at  the  cursor 

<32> 

Shifted 

BACK 

Delete  the  contents  of  the  line  to  the  left  of 
cursor;  if  at  the  beginning  of  the  line,  the 
cursor  moves  to  the  end  of  the  previous  line. 

<33> 

Shifted 

FWD 

Delete  the  contents  of  the  line  to  the  right  of 
the  cursor;  if  at  the  end  of  the  line,  the 
cursor  moves  to  beginning  of  the  next  line. 

<3/l> 

Shifted 

WORD  LEFT 

Delete  one  word  to  the  left  of  cursor. 

<3b> 

Shifted 

WORD  RIGHT 

Delete  one  word  to  the  right  of  cursor. 

If  the  current  line  has  multiple  "fields”  on  it,  as  described  in  VIA  above,  the  delete  forward 
or  delete  back  a line  acts  only  on  the  current  field.  That  is,  holding  SHIFT  down  and 
pushing  BACK  deletes  to  the  beginning  of  the  current  field  or,  if  at  the  beginning,  moves 
the  cursor  to  the  end  of  the  previous  enterablc  field.  Holding  SHIFT  down  and  pushing 
fWD  deletes  to  the  end  of  the  current  field  or,  if  at  the  end,  moves  the  cursor  to  the 
beginning  of  the  next  enterable  field. 

C.  WINDOW  CONTROL  INTERNAL  DISPATCHES 

These  dispatches  allow  the  user  to  alter  which  part  of  the  total  contents  of  the  window 
the  screen  is  displaying. 

1.  Scroll  Up  Dispatch 

<36> 

Key  - ROLL  UP 

2.  Scroll  Down  Dispatch 

<3/> 
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Key  - ROIL  DOWN 


1 lie  trxt  in  the  screen  window  is  moved  one  line  in  the  direction  specified.  Scroll  Notices 
may  be  generated  by  this  Keyboard  dispatch  (sec  Section  III  B). 

D.  MINI  INC,  SYMBOLS,  FUNCTION  KEYS,  AND  SPECIAL  INTERNAL  DISPATCHES 

These  dispatches  control  text  insertion,  cause  break  Notices,  and  miscellaneous  special 
functions,  respectively. 

I.  Insert  Dispatch 

</|3>  <CI  IARAC1 1 R> 

Key  - Any  printing  symbol  including  space,  Tab,  Control  Keys 

The  character  given  by  <CHARACT£R>  is  inserted  at  the  cursor  position.  The  rest  of  the 
text  on  the  line  and  the  cursor  move  one  position  to  the  right.  If  the  domain  is  not 
editable,  but  the  adjacent  character  to  the  left  is  in  an  editable  domain,  the  character  is 
included  in  that  editable  domain.  If  the  adjacent  character  is  also  not  in  an  editable 
domain,  the  bell  is  rung  and  the  dispatch  ignored. 

Any  printing  Key  hit  while  the  Control  Key  or  the  lab  Key  is  depressed  will  store  unique 
printing  symbols  for  the  appropriate  control  code  (see  HP  2605  owner’s  manual  for  the 
font  for  these  3?  characters),  lhe  terminal  treats  these  as  any  other  printing  symbol. 
Thus  Control  M docs  not  cause  the  same  operations  as  the  Carriage  Return  Key. 

P.  Break  Dispatch 

<dl>  <[5FXAKCODE> 

Key  - Any  function  Key 

fir-. I,  the  terminal  Keyboard  is  inhibited  and  the  global  No  Vacancy  flag  is  set.  Then  any 
change  to  a domain  that  is  not  yet  reported  is  reported  in  a Change  Domain  Notice.  Finally 
a HrcaK  Notice  is  generated,  which  reports  the  particular  Function  Key  strucK,  through  the 
break  code  <DRL AKCODE>,  and  the  cursor  position,  lhe  terminal  remains  in  the  output 
stale  until  a Continue  dispatch  is  received  from  the  applications  program.  During  this  state 
user  input  is  queued  or  ignored  (see  Section  II  F 2). 


3.  Here  Dispatch 


2b 


Key  - HI  HE 

If  the  current  domain  does  not  have  the  "HERE'S  allowed"  capability,  the  request  is  ignored 
and  the  terminal  bell  is  rung.  If  the  capability  is  allowed,  the  domain  at  the  cursor  is  split 
into  two  or  possibly  three  domains,  the  character  at  the  cursor  position  is  highlighted  as  a 
HI  RE  (by  inverting  the  video  level),  and  a HERE  notice  is  generated  (see  Section  III  A A). 

4.  EOL  Dispatch 

<i\?> 

Key  - Carriage  Return 

If  the  EOL  capability  for  the  domain  is  not  enabled,  the  bell  is  rung  and  the  request  is 
ignored.  If  allowed,  the  domain  is  split  at  the  cursor  position  with  a space  appended  to  the 
first  part,  and  the  second  part  made  into  a new  domain  with  the  "start  at  left  margin"  bit 

set. 

Ihc  appearance  on  screen  is  what  one  would  expect  a Carriage  Return  to  do,  i.e.,  break 
the  current  line  and  start  a new  one.  An  EOL  Notice  is  generated,  and  Scroll  Notices  may 
be  generated  (see  Section  III  8). 
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l' / /.  COM  MLJNIC/U'ION  riiO'IVCOI. 


The  fll’/MME  Terminal  communicates  with  the  application  host  via  dedicated  full  duplex, 
standard  PS232,  asynchronous  data  communication  lines.  It  does  not  support  multidrop  or 
polling.  lhc  terminal  is  designed  to  operate  at  up  to  2400  baud.  The  terminal 

communicates  in  block  mode.  Blocks  from  the  terminal  are  Notices.  Blocks  to  the  terminal 

an-  Dispatches.  The  Notices  and  Dispatches  are  variable  length,  but  the  maximum  length  of 
either  (e.g.,  a maximum  Create  Domain  dispatch)  is  110  bytes,  not  counting  communication 
protocol  header  and  trailer. 

I lie  terminal  requires  full  duplex  communication,  although  it  is  basically  a two-state  device. 
Hie  keyboard  is  active  in  input  state,  while  in  output  state  the  key  strokes  are  either 
ignored  (causing  a bell)  or  stored  (and  have  no  other  effect)  until  the  terminal  is  returned 
to  input  state,  at  which  time  they  are  processed.  During  input  state,  the  application 

computer  should  not  send  dispatches  that  may  alter  mapped  windows,  but  other  dispatches 

m.iy  be  sent.  During  output  state  the  terminal  will  not  issue  keyboard-generated  notices, 
but  Scroll  and  Error  Notices  may  occur  at  any  time. 

The  intent  of  the  Communication  Protocol  design  is  to  provide  a minimum  reduction  in 
bandwidth. 

for  error  detection,  a one-byte  block  checksum  is  used.  Blocks  received  in  error  are 
retransmitted.  Each  block  is  assigned  a one-byte  sequence  number  which  is  used  to 
identify  transmissions. 

A 7 HANS  MISS  ION  FORM 

* 1 1 at ***************************** 

* SIX  * SN  * DISPATCH  * El X * CC  * 

i i * *** ***************************** 

lath  dispatch  or  notice  is  surrounded  with  header  and  trailer  information.  The  unique 
character  SIX  is  first  sent  to  identify  the  beginning  of  a transmission.  The  Start  of  Text 
byte  (SIX)  identifies  the  transmission  to  be  a data  message  rather  than  one  of  the  control 
messages,  which  arc  described  later. 


following,  the  SIX  is  a single-character  Sequence  Number  (SN).  This  identifies  a particular 
transmission  and  its  sequential  position  relative  to  other  transmissions.  If  retransmitted,  it 
carries  lhc  same  Sequence  Number.  Sequence  numbers  are  in  the  range  100-177  octal. 
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control  codes.  To  avoid  confusing  data  in  the  body  of  the  dispatch  (or  notice)  with  these 
control  codes,  all  dispatch  data  characters  are  first  filtered  and  transformed  as  follows: 

1.  All  data  bytes  transmitted  are  in  the  range  AO-177 
octal. 

2.  the  data  characters  with  codes  0-37  and  077  octal  are 
transmitted  as  a two-character  sequence: 

a.  the  character  ? (code  077  octal), 

b.  the  desired  character  code  plus  AO  octal 
(except  ? which  is  not  changed). 

At  the  reception  side,  such  characters  are  transformed  back  to  their  original  code. 

The  first  data  byte  of  the  body  is  the  length  of  the  dispatch  (notice).  This  byte  may  be 
any  character  between  3 (the  minimum  dispatch  length)  and  127  octal.  Thus  it  may  be 
sent  as  a one  or  two-character  sequence. 

lhc  end  of  the  body  is  identified  by  another  unique  character,  tlX.  the  last  character  of 
the  transmission  is  a checksum  character  (CC).  This  character  is  used  for  error  detection. 
It  is  a seven-bit  character  generated  by  the  transmitting  process  as  the  two’s  complement 
of  the  sum  (without  end-around  carry)  of  all  characters  of  the  original  dispatch  from  (and 
including)  the  SIX  up  to  (and  including)  the  last  E.1X.  Note  that  the  checksum  is  on  the 
transmission  before  control  characters  are  converted  to  the  two-character  sequence. 
Since  the  CC  can  be  any  number,  it  is  also  transformed  into  a two-character  sequence  if 
it;,  value  is  less  than  AO  octal.  The  reception  process  must  keep  a running  sum  of  received 
characters  until  it  recognizes  the  EIX,  then  add  its  results  to  the  checksum  character.  If 
the  result  is  not  zero,  the  transmission  is  considered  to  be  in  error. 

ft.  C.ON1  HOL  MSS  ACES 

I wo  control  messages  are  used  to  acknowledge  receipt  of  a transmission.  The  negative 
a<  knowlcdgment  sequence 

1 ! tttt******** 

i NAK  * SN  * 

1 ! • U»*t**»*»* 

is  sent  when  a transmission  is  received  in  error  (cither  a protocol  or  checksum  error), 
lhc  SN  of  this  message  is  the  SN  of  the  last  good  transmission  that  has  been  received. 
Note  that  the  device  that  generates  this  NAK  is  referring  to  the  SN  of  its  received 
messages,  not  its  transmitted  message  SN.  the  other  sequence  which  is  used  is  a positive 
acknowledgment  sequence. 
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* i *********** 

i A CK  * SN  * 

* i 1 ********** 

ir.  sent  lo  indicate  successful  receipt  of  a dispatch  or  notice,  lhe  SN  of  this  control 
message  is  lhe  highest  SN  received  successfully  (i.e.,  the  transmission  just  received). 

C.  PROTOCOL 

lo  provide  flow  control,  acknowledgments  may  be  sent  after  every  successful  dispatch  or 
notice  receipt.  II  a message  is  received  in  error,  NAK  is  always  sent,  requesting 
retransmission.  This  implies  the  computer  and  terminal  must  keep  old  messages  around  for 
some  period  of  time  before  discarding  them.  The  amount  of  storage  required  is  a function 
of  the  channel  delay  time  and  whether  the  transmission  process  hangs  up  until  the  last 
transmission  is  acknowledged,  lhe  MML  terminal  will  not  send  another  notice  until  the 
previous  one  has  been  acknowledged,  lhe  computer  should  not  be  so  restricted.  In  order 
lo  reduce  the  load  on  the  host  processing  acknowledgments,  the  terminal  acknowledges 
only  dispatches  wilh  sequence  numbers  0 or  32  and  the  last  dispatch  of  a sequence  of 
dispatches.  I his  latter  condition  is  established  when  the  terminal  has  received  no  further 
dispatches  for  a period  ol  about  2 seconds. 

When  an  error  is  detected  (by  the  terminal)  a NAK  message  with  the  last  good  SN  is 
returned  (e  g.,  SN  n- 1).  Subsequently  other  messages  may  be  received  (c.g.,  SN  m 1,  n*2). 
1 In  sc  will  be  thrown  away  and  negatively  acknowledged.  Upon  receipt  of  the  NAK 
identifying  the  last  good  message  (n-1)  the  transmitting  process  should  stop  any  further 
transmission,  rcsynchronizc  (sec  below),  and  retransmit  the  message  n.  If  it  never  sent  n, 
the  transmitter  should  rcsynchronizc.  The  transmitting  process  can  then  return  to 
Ir  ansmilting  subsequent  (ml,  ...  ) transmissions  normally. 

1).  PI  S y NC.  UPON  I /AT  ION 

Since  new  transmissions  arc  held  up  whenever  a NAK  is  received,  and  a subsequent  ACK 
may  get  garbled  and  lost,  it  is  important  that  a transmitting  process  not  wait  forever  for 
an  ACK.  II  should  pull  itself  out  of  wait  state  after  an  appropriate  delay  (b  - 10  seconds) 
and  try  to  find  the  state  of  the  receiving  process.  This  is  done  by  the  resynchronizing 
control  sequence,  this  sequence  is  also  used  when  a NAK  or  an  out-of -sequence  ACK  is 
received. 

* ‘ 1 *********** 

• ENQ  * ENQ  * 

i i i *********** 

Upon  recognition  of  this  enquire  sequence  the  receiving  process  should  reset  its  state 
ready  to  accept  a new  SIX  and  send  back  the  control  sequence: 


' 


f : 


: 
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*1 *********************** 

* SYN  * SN  * SYN  * SN  * 

*m  ********************* 

where  the  sequence  number  (SN)  is  the  last  good  dispatch  (notice)  received.  This  will 
identify  to  the  transmitting  process  what  is  the  proper  next  transmission.  This  control 
sequence  is  a four-character  sequence  to  minimize  the  probability  of  spurious  synchronize 
acknowledgments. 

If  the  transmitting  process  does  not  receive  an  appropriate  acknowledgment  sequence,  it 
should  try  a new  enquire  sequence.  If  the  enquire  sequence  continues  to  fail,  the 
transmitting  process  should  attempt  to  initialize,  as  described  in  the  next  section. 

F.  INI  1 1AL  1ZA1  ION  AND  RESET 

At  start  up  or  when  processes  get  totally  confused  so  they  can  not  resynchronize,  both 
sender  and  receiver  must  reset  their  sequence  numbers  to  some  initial  state,  to  do  this 
the  following  Reset  sequence  control  is  provided. 

*tt*  ******************** 

* SYN  * 0 * SYN  * 0 * 

* ; i ********************* 

If  the  computer  sends  this  sequence  to  the  terminal,  the  terminal  will  set  its  Reception 
Sequence  Number  to  0,  and  will  return  a special  Reset  Acknowledgment: 

* i ********************** 

* SYN  * 1 * SYN  * 1 * 

************************ 

If  the  terminal  and  computer  reach  a point  where  they  must  reset  their  sequence  numbers, 
they  most  likely  will  also  have  to  reset  the  entire  terminal  state. 

E.  CODES 


The  following  ASCII  codes  are  specially  recognized  by  this  protocol: 
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OcM 

Hex 

Mcaninn 

SIX 

00? 

0? 

Start  of  Text 

ACK 

00G 

06 

Acknowledge 

NAK 

025 

15 

Negative  Acknowledge 

ENQ 

005 

05 

Enquire 

E IX 

003 

03 

End  of  Text 

SVN 

026 

16 

Synchronize 

CC  is  ur.ed  in  this  document  to  represent  the  checksum  character,  which  may  be  any  7-bit 
code. 

SN  is  used  to  represent  a Sequence  Number  Character,  which  may  be  any  code  in  the 
range  100  to  177  (octal). 
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APPENDIX  I 

INDEX  OE  DISPATCHES  AND  NOTICES 


1 1 u?  following  tabic  lists  each  dispatch  by  name  followed  by  which  section  contains  the 
description  of  the  dispatch,  its  function  code  and  its  parameters. 


DISPATCH 

SECTION 

CODE  PARAMETERS 

Allocate 

II  A1 

1 

<WINDOW><ATTRIBUTES><SECURITY  LEVEL> 

Deallocate 

II  A2 

2 

<WIND0W> 

Map  Window 

II  A3 

3 

<WINDOW><SCREENLINE><SCREENLINE> 

Unmap  Window 

II  A4 

4 

<WIND0W> 

Clear  Window 

II  Ab 

5 

<WINDOW> 

Change  Window  Atlrib. 

II  A6 

44 

<WIND0W><AT  1 RIBUTESxSECURITY  LEVEL> 

Create  Domain 

II  01 

6 

<WINDOW><DOMID><LEFTDOMID><CAPAB> 
<rORMAT><UILIT  E><TEXT> 

De  lete  Domain 

II  02 

7 

<WIND0W><D0MID> 

Append 

II  03 

8 

<WIND0W><D0MID><T  EXT  > 

Modify  Domain 

II  04 

9 

<WINDOW><DOMID><CAPAB><FORMAT><HILITE> 

Change  Text 

II  lib 

10 

<W/ND0W><D0M)D><7EXT> 

Split  Domain 

II  06 

11 

<WIND0W><01  DDOMIDxNE  WD0MID> 

INTEGER  1 ><BEGINNING/END> 

Join  Domains 

II  07 

12 

<WINDOW><KEEPDOMID><DELDOMID> 

Character  Position 

II  Cl 

13 

<WINDOW><DOMID><INT  EGER  1 > 

Screen  Position 

II  C2 

14 

<WIND0W><INTEGER1> 

Show  Cursor 

II  C3 

15 

<WIND0W> 

Flash  Size 

II  D1 

16 

<INTEGER1> 

Flash  1 ext 

II  D2 

17 

<SCREENLINE><TEXT  > 

Elell 

II  Ell 

18 

Continue 

II  E 2 

19 

<INTEGER1> 

Reset  Terminal 

Set  Screen  Security 

II  E3 

20 

l ights 

il  E4 

21 

<SECURITY  LEVEL> 

Cursor  Up 

VI  A 

22 

Cursor  Down 

VI  A 

23 

Cursor  left 

VI  A 

24 

Cursor  Right 

VI  A 

25 

Word  Left 

VI  A 

26 

Word  Right 

VI  A 

27 

Hack 

VI  A 

28 

Forward 

VI  A 

29 

r 


r 
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Up  Window 

VI  A 

38 

Down  Window 

VI  A 

39 

Delete  Char  Lett 

VI  If 

30 

Delete  At  Cursor 

VI  B 

31 

Delete  Hack 

VI  B 

3? 

Delete  I- or  ward 

VI  B 

33 

Delete  Word  Left 

VI  B 

34 

Delete  Word  Right 

VI  B 

35 

Scroll  Up 

VI  Cl 

36 

Scroll  Down 

VI  C? 

37 

Insert  Character 

VI  D1 

43  <CHARAC1 ER> 

Hreak 

VI  D2 

41  <BREAK  C0DE> 

Here 

VI  D3 

40 

EOl 

VI  D4 

42 

The  following  table  lists 

each 

notice  by  name  followed  by  which  section  contains 

description  of  the  notice,  its  function  code  number,  and  its  parameters. 

NO  I ICE 

SECTION  CODE  PARAMETERS 

Changed  Domain 

III  At 

0 

<WINDOW><DOMID><TEXT> 

f xtraclion 

III  A? 

1 

<WIND0W><0L  DD0MID><NEWD0MID> 

<BC  GINNING/ENDxT  EXT> 

[freak 

Ill  A3 

2 

<WiND0W><D0MiD><L0C  IN  DOMAIN><WINDOW  L0C> 
<BREAK  C0DE> 

Here 

III  A4 

3 

<WIND0W><D0MID><L0C  IN  DOMAIN><MDOMID> 

<ADOMID> 

EOl 

III  Ab 

4 

<WIND0W><D0MID><L0C  IN  DOMAIN><NDOMID> 

<SI’l  CIAL> 

Scroll 

III  m 

5 

<WINDOW><DOMID><T  OP/BOT  > 

Vac  ant 

III  [3? 

6 

<WINDOW><T OP/BOT ><FREE  LINES> 

Error 

Ill  C 

7 

<ERR0R  C0DE><FUNCTI0N  C0DE><BYTE1><BVTE?> 
<BY1 E3> 
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appendix  n 

EXAMPLES  OF  EOI.  NOTICES 


lhc  table  below  shows  examples  of  how  the  terminal  handles  EOI  under  different 
conditions.  The  lines  with  []’s  show  what  is  on  the  screen.  The  format  is  [<<format 
codc><domid>)  text  in  domain].  The  format  codes  are: 

? unknown 

♦ slart-at-lcft-margin  format  domain 
- non-formatlcd  domain 

T lie  lines  such  as  CR?>'D  record  user  inputs  such  as  carriage  return  at  the  D.  The  notice 
lines  are  DM  for  <DOMID>,  LD  for  <LOC  IN  DOMID>,  and  S for  <SPECIAL>.  Domain  identifiers 
greater  than  40  arc  terminal-  created  identifiers. 

Normal  Operation:  where  user  inputs  two  carriage  returns  to  generate  blank  line 
Example  1 Example  2 Example  3 

Original  Screen  Model: 

[<?l)ABC]f(?2)DEF]  [<?1)ABCDEF]  [(?1)ABCDEF] 

User  Inputs: 

CRmD  CRiroD  CRifi>D 

Result: 

NO  I ICE:  NOTICE:  N01ICE: 

DM  ?,ID=0,S'0  DM=  1.LD-3.S-0  DM~1,LD=3,S=0 

[(?l)ABC][(?2)space]  [(?l)ABCspace]  [(’l)ABCspace] 

[<*41)DEF]  [(+41)DEF]  [041)DEF] 

User  Inputs: 

CRwD  CRjbD  CRi^space 

Result: 

NOTICE:  NOTICE:  NOTICE: 

DM^/ll.LD-O.S-O  DM-4J,LD=0,S-0  DM=l,LD-3,S-0 

[(?J)ABC]f(?2)space]  [<?l)ABCspace]  [(?l)ABCspace] 

[(■*41)spacc]  [<+41)space]  [(-t42)space] 

[042)DCF]  [042)DEF]  [041)DEF] 
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Spcci.nl  Case:  where  user  inputs  only  one  carriage  return  to  generate  blank  line 


Result: 


t x ample  4 

Example  5 

Example  6 

Screen  Model: 

[<V1  )AUC 

[(?  1 )ABC] 

[ODABC] 

1)1  1 j 

t(-2)DEF] 

[02)DEF] 

nuts: 

CRr.'D 

CR.sD 

CR.r>D 

NO  1 ICt : 

NO!  ICF: 

NO!  ICE: 

DM  1,1  f)=3,S-42 

DM-2,LD-0,S=1 

DM=  2,LD=0, 

[<?  1 )AHC 

[<?1)ADC] 

[<?1)ADC] 

space] 

[02)space] 

[02)space>] 

[041  )Dt  f ] 

[04DDEFJ 

[(  + 41  )DEF] 

SI’ICIAL  1 

SPECIAL  2 

NO  SPECIAL 

[01  )A(?C] 

[(?  1 )ABC] 

[042)space] 

[02)space] 

10  4 1 )DEF ] 

[(-»41)DEF] 

Note  that  in  Example  4,  the  space  generated  by  the  EOL  is  made  into  a separate  domain. 
I he  <5I’I  CIAI  > argument  bcinp  a terminal-  penerated  domain  ID  identifies  this  special  case. 
In  f x ample  b,  the  space  penerated  by  the  EOL  is  already  a separate  domain,  but  it  has 
been  converted  to  a “formatted"  domain.  This  is  distinguished  by  the  fact  that<SPECIAL>  is 
the  value  1.  In  all  other  cases  <Sf’ECIAL>  is  0. 
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APPENDIX  III 

INITIAL  WINDOW  EXAMPLE 


Values  shown  in  this  example  are  in  octal.  A window  is  normally  initialized  in  four  steps: 

1)  ALI  OCATION 

2)  DOMAIN  CRE  ATION 

3)  CURSOR  POSITION 
A)  DISPLAY 

1.  Window  Allocation 

<Al  I OCA1  E>  <7>  <1>  <"SM> 

This  dispatch  allocates  window  7 as  a large  window  with  the  security  classification  Secret. 
For  this  example  Scroll  Notices  are  not  inhibited. 

2.  Domain  Creation 

<CRCATE>  <7>  <0,1>  <1 77,1 77>  <170>  <0>  <0>  <TEXT> 

T his  dispatch  creates  domain  1 at  the  end  of  window  7.  The  domain  is  enterable  and 
editable  with  both  "Hcre"s  and  Carriage  Returns  allowed.  It  has  no  special  formatting, 
hilifes,  character  set  or  margin.  Succeeding  domains  are  created  in  a similar  manner. 

3.  Cursor  Position 

CHARACTER  POSITION  <7>  <0,A>  <0> 

This  dispatch  positions  the  implicit  cursor  in  window  7 on  the  first  character  of  domain  A. 
<5CREEN  POSIT ION>  <7>  <1> 

This  dispatch  positions  the  cursor  in  window  7 on  the  second  line  of  this  window  on  the 
screen. 

A.  Display 

<MAP>  <7>  <16>  <23> 


This  dispatch  maps  the  window  onto  lines  16  through  23  (the  bottom  8 lines  of  the 
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screen).  The  implicit  cursor  for  this  window  at  the  first  character  of  domain  4,  is  displayed 
on  screen  line  1 /. 

If  it  was  required  to  have  the  actual  cursor  moved  into  the  new  window  a Show  Cursor 
could  now  be  transmitted. 
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/l  I'PENDIX  IV 
ERROR  TYPES 


Frror  Code 

m Octal  Description 

1 Window  not  allocated 

? Zero  Domain  Identifier  not  allowed 
3 No  such  Domain  Identifier 

d Flash  Size  out  of  range 

5 Flash  Line  over  79  characters 

6 

7 (Not  Error)  Reset  Acknowledge 

10  No  such  dispatch  code 

1 1 Domain  Identifier  already  exists 

1?  Window  not  defined 

13  Window  already  allocated 

Id  Terminal  Memory  Full  - Must  delete  some  data 

Hi  Domain  already  mapped 

16  Line  already  mapped 

1 7 Line  out  of  range 

?0  Domain  Length  zero  not  allowed 

?\  Window  cither  not  mapped  or  not  allocated 
??  Adjacent  Domain  Identifier  does  not  exist 

?3  No  such  Security  Code 

?d  Internal  consistency  error  on  Block  Count 
?b  Internal  consistency  error  on  Line  Count 
?(>  Cannot  put  cursor  into  non-enterable  domain 
?/  No  implicit  cursor  in  window 

30  Split  length  not  compatible  with  domain  length 

31  Domain  length  too  long 

3?  Not  adjacent  domains 


F 
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A I' PEN  1)1  X V 

IIP  2640  SIMIKS  LOGIC  HOARDS 
IJSlil)  IN  TIIE  hi  ME  TERMINAL 


Hoard  1 ypo 

Description 

Ilf 

- 60)  ?3 

Keyboard  l/F 

HI* 

- 60086 

Asynch  Data  Comm 

III* 

- 601  P'1 

DMA 

III* 

- 601 l? 

Display  Control 

III' 

- 600?/! 

Display  Enhancement 

III* 

- 60088 

Display  liming 

m> 

- 60093 

Processor  (8080) 

ISI 

- 0GB 

PROM  Memory  (Address  0-1 6K) 

ISI 

- 0GB 

PROM  Memory  (Address  16-32K) 

up 

- 60065 

/)K  Memory  (Start  Address  44K) 

iii’ 

- 60101 

8K  Bottom  Plane  Memory  (Start  Address  48K) 

Hi* 

- 60101 

8K  Bottom  Plane  Memory  (Start  Address  56K) 

